home *** CD-ROM | disk | FTP | other *** search
/ SGI Developer Toolbox 6.1 / SGI Developer Toolbox 6.1 - Disc 4.iso / public / jpeg / libCLRjpeg4 / README < prev   
Text File  |  1994-08-01  |  4KB  |  122 lines
  1. JPEG for SGI Iris GL (release 1.02)
  2. ------------------------------------
  3. January 4, 1993
  4. (c) 1992,1993 Rodney Hoinkes, Centre for Landscape Research
  5. email: rodney@dgp.utoronto.ca
  6.  
  7. jpaste & jsave are IRIS GL programs for the capture
  8. and viewing of jpeg files.
  9.  
  10. In this library, you will find the following
  11. organization:
  12.  
  13. bin/    - binaries of utilities and examples
  14. src/    - source code to CLR additions as
  15.           well as basic library object files
  16.           and header files:
  17.         include4/ & JPEGobj4/ are for v4 of
  18.             the JPEG library
  19. examples/- sample source code built on the library
  20.            a screen saving 'jsave' and an image
  21.            display program 'jpaste'
  22.  
  23. CLRjpegExtern.h
  24.         - contains the function definitions within
  25.           the CLR JPEG library extentions.
  26.  
  27. NOTE:  Within src/include4 are two
  28. files, README.JPEG and USAGE.JPEG which include the
  29. information of legalities of using this code as well
  30. as issues of the JPEG format and quality concerns.
  31. PLEASE READ THESE FILES!
  32.  
  33. This library has been compiled using
  34. ANSI C and does not include the
  35. ansi2knr.c code which has certain
  36. licensing conditions.
  37.  
  38. The provided executables were
  39. compiled under IRIX 3.3.2 and should
  40. be upwardly compatible to IRIX 4.0.x
  41. system versions. They have been tested on
  42. IRIX 3.3.[0-2], 4.0.[145]
  43. PI 20TG, 25TG, 70GT, 310VGX, Entry Indigo.
  44.  
  45. All of the jpeg code which comprises the
  46. src/JPEBobj4 files has NOT been included.  The
  47. necessary .h files and sample code for reading and writing the
  48. files is included.
  49. If you wish the code that was used to create this library,
  50. check your favorite ftp sites or use the
  51. archie servers to find one that has it.
  52.  
  53. the JPEGobj4 and include4 directories are based upon:
  54. jpegsrc.v4.tar.Z
  55.  
  56. This release is intended to be simple for people
  57. to work with and integrate into their existing
  58. or new code.  It is NOT supported by me.  I am
  59. releasing it for general consumption and use at
  60. your own risk blah blah blah.
  61.  
  62. The only restrictions on use are those
  63. stated with the original library and found within
  64. the README.JPEG and USAGE.JPEG files.
  65.  
  66. Good Luck and enjoy the disk space savings!!
  67.  
  68. Procedures Accessable through libCLRjpeg4.a:
  69.  
  70. --------------------------------------------------------------------------
  71. extern unsigned long *LoadJPEGImagePtr(char *name,int *xsize,int *ysize);
  72.  
  73. this procedure accepts the name of a jpeg file which it will load
  74. into a chunk of memory suitable for lrectwrite operations.  This pointer
  75. will be returned by the procedure as well as updating an xsize and ysize
  76. variable passed to it defining the size of the image.  If an error occurs,
  77. the procedure will return a NULL pointer.
  78.  
  79. --------------------------------------------------------------------------
  80. extern void LoadJPEGImageScreen(char *name, int sx, int sy);
  81.  
  82. this procedure accepts the name of a jpeg file which will be displayed
  83. on screen, with its lower-left corner at sx,sy.
  84.  
  85. --------------------------------------------------------------------------
  86. extern void SaveJPEGImagePtr(char *name, unsigned long *data, int xsize, int ysize);
  87.  
  88. this procedure will save out an lrect format image block in 24bit jpeg
  89. colour to the file specified by name.
  90.  
  91. --------------------------------------------------------------------------
  92. extern void SaveJPEGImageScreen(char *name, int x1,int y1,int x2,int y2);
  93.  
  94. this procedure will save out a section of the screen to a 24bit jpeg
  95. colour image with the specified name.
  96.  
  97. --------------------------------------------------------------------------
  98. extern char *GetJPEGVersion();
  99.  
  100. this procedure will return the verion number and date of the jpeg library.
  101. --------------------------------------------------------------------------
  102.  
  103. Changes in v1.01:
  104. -----------------
  105. Thanks to Eric Williams of SGI for some bug fixes
  106. and enhancements to this implementation.  This
  107. version supercedes his implementation of 'jpaste'
  108. which was based upon v2 of the JPEG library.
  109.  
  110. Changes in v1.02:
  111. -----------------
  112. The official v4 release of the JPEG library has been
  113. incorporated to fix any v3b problems.  Code compatibility
  114. should remain the same.  CLR additions have been made to
  115. allow easier integration of the JPEG into your existing
  116. GL code.  lrectread/write format can be loaded and/or
  117. saved without going to screen, and/or loads/saves can
  118. be performed right to/from the framebuffer.  I hope these
  119. new wrappings on the code make it easier to incorporate
  120. for people.  If you like the new wrapping better, let me
  121. know!
  122.